home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr27 / pixplot.zip / MANUAL.DOC < prev    next >
Text File  |  1993-04-27  |  16KB  |  358 lines
  1.       J E W E L L   T E C H N O L O G I E S ,   I N C O R P O R A T E D
  2.  
  3.  
  4.                         P I X E L P L O T  User Manual
  5.  
  6.                                 Version 1.1
  7.  
  8.  
  9.  
  10.  
  11.                        Contents:
  12.                            1.0  INTRODUCTION
  13.                            2.0  RUNNING PIXELPLOT
  14.                            3.0  SUMMARY OF KEYSTROKES
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                     PIXELPLOT(tm) User Manual and Program:
  21.                    Copyright 1992 Jewell Technologies, Inc.
  22.                               All Rights Reserved
  23.                         
  24. ------------------------------------------------------------------------------
  25. 1.0 INTRODUCTION
  26.  
  27.     The PixelPlot(tm) software program lets you print any HP 
  28.     Plotter Language (HPGL or HPGL/2) file directly to your printer, 
  29.     eliminating the need for a pen plotter.   Output is fast and clear, 
  30.     utilizing the maximum resolution available on your printer.  Color 
  31.     output is available on color printers.  
  32.     
  33.     Be sure to view the "READ.ME" file before using PixelPlot.  To 
  34.     view the "READ.ME" file on your screen, type the command 
  35.     "README" with the PixelPlot diskette contents in the default 
  36.     disk drive and directory.
  37.  
  38. 1.1 Description
  39.     PixelPlot  will produce fast, high quality output of your 
  40.     HPGL and HPGL/2 graphics files on virtually any dot 
  41.     matrix, inkjet, or laser printer with bit-mapped graphics 
  42.     capability.
  43.     
  44.     The printed output may be sized, positioned, and 
  45.     oriented (landscape or portrait) however you wish , and 
  46.     may be sized to fit the maximum size of paper available 
  47.     to your printer.  You may also View your output on 
  48.     the screen to see exactly how it will appear on the 
  49.     paper, saving both time and resources.
  50.  
  51. 1.2 System Requirements
  52.     PixelPlot runs on the IBM Personal Computer, IBM 
  53.     PCjr, IBM Model 3270, IBM AT, IBM PS/2, or any 
  54.     IBM-compatible computer, and will read any file 
  55.     created in the HPGL or HPGL/2 plotter language.
  56.  
  57. 1.3 Manual Conventions
  58.     This manual uses the following conventions:
  59.  
  60.     CAPITAL LETTERS   Indicate what you should type.
  61.     -->               This symbol indicates a special note.
  62.     <...>             Angle Brackets in bold indicate keys on your 
  63.                         keyboard, for example <Enter> means press 
  64.                         the Enter key.
  65.  
  66. 1.4 Technical Support
  67.     You may write to us at:
  68.         Jewell Technologies, Inc.    
  69.         2200 Sunset Ave SW        
  70.         Seattle, WA 98116   
  71.  
  72.     Or call our BBS at: 
  73.         (206) 937-0788     
  74.  
  75. ------------------------------------------------------------------------------
  76. ------------------------------------------------------------------------------
  77. 2.0  RUNNING PIXELPLOT 
  78.     PixelPlot may be run in two different manners:  through 
  79.     its menu program, or through a command line.  Use of the 
  80.     menu program is described in sections 2.1-2 of the 
  81.     manual, while command line execution is described in 
  82.     detail in section 2.3.  
  83.  
  84. 2.1 The Menu Program
  85.     To execute PixelPlot, simply change directories to the 
  86.     PixelPlot directory and type:
  87.  
  88.         PP<Enter>
  89.  
  90.     If you have a black and white monitor, you may specify 
  91.     so by typing:
  92.  
  93.         PP /B<Enter>
  94.     
  95.     The Plot button will currently be highlited.  If the file 
  96.     selected is correct and you wish to begin printing 
  97.     at this point, press <Enter> and PixelPlot 
  98.     will output the selected file.
  99.  
  100.     If you wish to change from input field to input field, 
  101.     you may do so by typing <Tab> key to move forwards and 
  102.     <Alt><Tab> to move backwards. You may also use the left 
  103.     and right arrow keys. Optionally, you may type the upper 
  104.     case letter of the title of the field you wish to select 
  105.     for example to select a file, you will find the heading Files.  
  106.     Typing <F>, then, will highlite this field.
  107.     
  108.     As you move from field to field, the currently selected 
  109.     field will be signified by a double lined box 
  110.     surrounding it in a highlited white.  Instructions will 
  111.     appear in the box at the bottom of the screen, 
  112.     explaining the operation and purpose of the field.  The 
  113.     fields are individualy described below.
  114.  
  115. 2.2 Individual Descriptions of Input Fields
  116.  
  117.     Files:    Files will list all files in the current drive and directory 
  118.         with their extension corresponding to the current 
  119.         Extension field selection.  To select a file, highlite the 
  120.         name you wish to select by using the <Up> and 
  121.         <Down> arrow keys.  When the correct file name is 
  122.         highlited, press <Enter>.   You will notice that the file 
  123.         selection above will be updated.  This shows that the 
  124.         new file is selected.
  125.  
  126.     Directory: Dir will list all directories and subdirectories available 
  127.         on you current drive.  To select a new directory, 
  128.         highlite the new entry by using the <Up> and <Down> 
  129.         arrow keys.  When the correct directory name is 
  130.         highlited, press <Enter>.  The Files list will be 
  131.         updated as will the Path and File selections above.  As 
  132.         with DOS, moving backwards through directory levels 
  133.         is achieved by using the [..] option.  To move back, 
  134.         select this option (if listed) and press <Enter>.
  135.  
  136.     Extension: Extension lists several popular HPGL file extensions.  
  137.         Also, the DOS wildcard (*.*) is supplied to allow you 
  138.         to view all files in your directory.   The current 
  139.         selection is specified by a  X in the box to its left.  To 
  140.         select a new extension, use the <Up> and <Down> 
  141.         arrow keys.   As you do this, the X will move from box 
  142.         to box.  Also, you will notice that different files are 
  143.         listed in the Files field as you change this selection.
  144.  
  145.     Drive:    drIves will list all drives available to your computer.  
  146.         To select a new drive, highlite the new entry by using 
  147.         the <Up> and <Down> arrow keys.  When the correct 
  148.         drive letter is highlited, press <Enter>.  The Files list 
  149.         will be updated as will the Directory, path and file 
  150.         fields.
  151.  
  152.     Printer: priNter will list all available printer drivers.  To select 
  153.         a printer driver, highlite the new entry by using the 
  154.         <Up> and <Down> arrow keys.  <End> will move you to the end
  155.         of the list, <Home> will move you to the beginning. <PgUp>
  156.         and <PgDn> scroll the field by four lines.
  157.     -->Note: If your printer is not listed, please view the JTIPRINT.DOC
  158.          file for a more complete list of printer types supported.    
  159.  
  160.     Size:    The Size field contains three sub-fields:  Aspect ratio, 
  161.         X, and Y.
  162.  
  163.     Aspect:    By checking the Aspect ratio box, you are telling 
  164.         PixelPlot to maintain the x to y ratio of you original file 
  165.         as it prints it to the printer (i.e.  circles will appear as 
  166.         circles--otherwise they will most likely appear as 
  167.         ellipses).  To select or deselect this field, press 
  168.         <Enter>.  When the box contains an X it is selected. 
  169.  
  170.     X:    The X field contains the maximum size in inches the 
  171.         image will cover across the sheet of paper.  (On an 8.5" 
  172.         x 11" piece of paper, X specifies the 8.5" direction.)  If 
  173.         Aspect ratio is not checked, the output will be exactly 
  174.         this size, otherwise, this is the maximum size.   To 
  175.         change the image size in the x-direction, simply enter 
  176.         the new value and press <Enter>, <Tab>, or 
  177.         <Shift><Tab>.  Maximum values are defined by the 
  178.         current Media size.
  179.  
  180.     Y:    The Y field contains the maximum size in inches the 
  181.         image will cover down the sheet of paper. (On an 8.5" 
  182.         x 11" piece of paper, Y specifies the 11" direction.)  If 
  183.         Aspect ratio is not checked, the output will be exactly 
  184.         this size, otherwise, this is the maximum size.   To 
  185.         change the image size in the x-direction, simply enter 
  186.         the new value and press <Enter>, <Tab>, or 
  187.         <Shift><Tab>.  Maximum values are defined by the 
  188.         current Media size.
  189.     
  190.     Offset: Offset contains two fields indicating the Left, and Upper
  191.         printer margins.
  192.     
  193.     L:    The L field contains the offset in inches from the left
  194.         side of the page.
  195.     
  196.     U:    The U field contains the offset in inches from the upper
  197.         margin of the page.
  198.  
  199.     -->Note:     Margin size plus output size cannot be greater than 
  200.             the media size.  PixelPlot will subtract the margin 
  201.             size from the media size to arrive at a new output 
  202.             size, if the values are too great.
  203.  
  204.     Media:    Media lists available paper sizes.  You may select any 
  205.         size, so long as your printer is able to handle the size of 
  206.         paper.   Again, select a new paper size by using the 
  207.         <Up> and <Down> arrow keys.  Sizes are as follows: 
  208.             A-size (8.5"x11")
  209.             B-size (11"x17")
  210.             C-size (17"x21")
  211.             D-size (22"x34")
  212.  
  213.     Port:    porT lists available output ports.  Highlite the port 
  214.         name that your current printer is hooked up to by using 
  215.         the <Up> and <Down> arrow keys.
  216.  
  217.     Orientation: Orientation lists two options, portrait and landscape.  
  218.         The current selection is specified by an X in the box to 
  219.         its left.  To change selections, use the <Up> and 
  220.         <Down> arrow keys.   Portrait mode specifies that the 
  221.         sheet of paper is viewed with the width being the short 
  222.         direction and the length being the long direction (as in a 
  223.         business letter).  Landscape mode turnes everything 
  224.         ninety degrees often allowing for larger graphical 
  225.         output than portrait mode.  
  226.  
  227.     BUTTONS:
  228.         To use a button, highlite the button using the <Tab> or 
  229.         <Shift><Tab> keys, or type the upper-case letter in its 
  230.         title.  When it is highlited, press <Enter> to activate it.
  231.  
  232.         Info:    Selecting Info will display Information about Jewell
  233.                  Technologies and its products.
  234.  
  235.         View:    Selecting View will cause PixelPlot to display your 
  236.                  output on the screen.  The screen will display a 
  237.                  rectangle of white, representing the sheet of paper.  
  238.                  Output will appear on this page, showing you how your 
  239.                  picture will appear on paper.
  240.         -->Note:    Viewing may be aborted at any time by 
  241.                     pressing the <Esc> key.
  242.   
  243.         Plot:    Selecting Plot will cause PixelPlot to begin output to 
  244.                  your printer.  A percentage bar will appear at the 
  245.                  bottom of the screen telling you first how much of the 
  246.                  image has been built, and then how much has been 
  247.                  printed.
  248.         -->Note:    Printing may be aborted at any time by 
  249.                     pressing the <Esc> key.
  250.  
  251.         Quit:    Selecting Quit will exit PixelPlot.  As it exits, 
  252.                  PixelPlot will save the fields to a file called 
  253.                  PIXPLOT.INI.  When you run PixelPlot again, it will 
  254.                  default to your current settings.
  255.             
  256. ------------------------------------------------------------------------------
  257. 2.3 Running PixelPlot through a command line.
  258.  
  259.     You are able to run PixelPlot from a command line and 
  260.     bypass the use of the menu program.  Also, from this 
  261.     mode you are able to print multiple files from a single 
  262.     command.
  263.     
  264.     The format of the PixelPlot command line is:
  265.  
  266.     PP [commands...] FILENAME [filename...]
  267.  
  268.     Commands are all preceeded by a forward-slash "/".  If 
  269.     this is not present, then PixelPlot assumes that you are 
  270.     specifying a file name.  Available Commands are:
  271.     
  272.         /H      Lists command line help options.
  273.         /B      Tells PixelPlot to work in Monochrome mode.
  274.         /X#.#   Specifies x-direction output size. (/X8.25 
  275.                    specifies 8.25" output in the x-direction).
  276.         /Y#.#   Specifies y-direction output size. (/Y10.5 
  277.                    specifies 10.5" output in the y-direction).
  278.         /OX#.#  Specifies offset from left of paper (/OX1.5 
  279.                    specifies a 1.5" left-hand margin).
  280.         /OY#.#  Specifies offset from top of paper (/OY.75 
  281.                    specifies a .75" top margin).
  282.         /L      Specifies landscape printing mode.
  283.         /P      Specifies portrait printing mode.
  284.         /LPT#   Specifies LPT port. (/LPT1 specifies lpt1 
  285.                    for output port).
  286.         /COM#   Specifies COM port (/COM2 specifies com2 
  287.                    for output port).
  288.         /V      Views the file on the screen rather than 
  289.                    printing it out.
  290.         /A      Tells PixelPlot to maintain the Aspect ratio 
  291.                    of the original file.
  292.         /NA     Tells PixelPlot to ignore Aspect ratio.
  293.         /Mx     Specifies paper size A-D. (/MD specifies 
  294.                    22"x34" paper).
  295.     
  296.     For the filename, you may enter any number of valid HPGL or HPGL/2 
  297.     format files, separated by spaces.  Files in other directories may 
  298.     be used by including their path, as in:  (c:/pictures/drawing.plt).
  299.  
  300. Example: 
  301.  
  302.     PP /P /X8.0 /Y10.0 /A dwg1.plt dwg2.plt
  303.  
  304.     This will instruct PixelPlot to print files dwg1.plt 
  305.     and dwg2.plt to your printer in portrait mode (/P), 
  306.     with a maximum width of 8.0" (/X8.0) and a 
  307.     maximum height of 10.0" (/Y10.0), while 
  308.     maintaining the aspect ratio of the original image (/A).   
  309.     All other fields, including output port, printer driver, 
  310.     etc. will default to whatever values were saved by the 
  311.     last execution of the PixelPlot menu program.
  312.  
  313. ------------------------------------------------------------------------------
  314. 3.0  Summary of Menu Program Keys
  315.  
  316.     <F>                 Select the Files list box
  317.     <D>                 Select the Directories list box
  318.     <E>                 Select the Extensions list box
  319.     <I>                 Select the drIves list box
  320.     <S>                 Select the Size box
  321.     <A>                 Select the Aspect Ratio field
  322.     <X>                 Select the output width dimension box
  323.     <Y>                 Select the output height dimension box
  324.     <O>                 Select the Offset box
  325.     <L>                 Select the Left margin box
  326.     <U>                 Select the Upper margin box
  327.     <M>                 Select the Media size list box
  328.     <T>                 Select the porT list box
  329.     <O>                 Select the Orientation list box
  330.     <N>                 Select the priNter list box
  331.     <I>                 Select the Info button
  332.     <V>                 Select the View button
  333.     <P>                 Select the Plot button
  334.     <Q>                 Select the Quit button
  335.     <Right Arrow>       Move Forward one field
  336.     <Left Arrow>        Move Back one field    
  337.     <Tab>               Same as <Right Arrow>    
  338.     <Shift-Tab>         Same as <Left Arrow>
  339.     <Down Arrow>        Scroll down through list box items
  340.     <Up Arrow>          Scroll up through list box items
  341.     <PgDn>              Scroll down one screen through list box items
  342.     <PgUp>              Scroll up one screen through list box items    
  343.     <End>               Move to End of list box items
  344.     <Home>              Move to beginning of list box items
  345.     <Esc>               Abort printing or viewing of files
  346.  
  347. -End of File-
  348. ------------------------------------------------------------------------------
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.     
  358.